home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat4 / snetd.options.z / snetd.options
Encoding:
Text File  |  2001-04-17  |  7.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. SSSSNNNNEEEETTTTDDDD....OOOOPPPPTTTTIIIIOOOONNNNSSSS((((4444))))                                              SSSSNNNNEEEETTTTDDDD....OOOOPPPPTTTTIIIIOOOONNNNSSSS((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      snetd.options - network configuration file
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The _s_n_e_t_d._o_p_t_i_o_n_s file describes the configuration of the _S_T_R_E_A_M_S network
  13.      constructed by _s_n_e_t_d(1M).
  14.  
  15.      The file is in two sections, separated by a line consisting of the
  16.      character sequence '%%'.  Blank lines may be used freely throughout the
  17.      file, and a _t_o_k_e_n (see below) beginning with an unquoted '####' (hash)
  18.      denotes a comment which lasts till the end of the line.  In addition, a
  19.      backslash (\\\\) immediately preceding the end of a line results in the
  20.      newline being treated as whitespace (except at the end of comment lines).
  21.  
  22.      _T_o_k_e_n_s consist either of
  23.  
  24.      a)   a single occurrence of the special characters { '=', '{', ',', '}' }
  25.  
  26.      (NNNNooootttteeee::::  '=' is _n_o_t a special character within the brace-enclosed argument
  27.      list of a control message; ',' is _o_n_l_y a special character in this
  28.      position.)
  29.  
  30.      b)   strings of arbitrary characters enclosed in single or double quotes
  31.           (''' or '"'), but not containing a newline - each quoting character
  32.           quotes the other, for example, "foo 'bar'" or '"foo" bar'
  33.  
  34.      (Newlines occurring within quoted strings will silently terminate the
  35.      string.)
  36.  
  37.      c)   sequences of non-whitespace characters not including any of the
  38.           special characters or quotes
  39.  
  40.      All strings are case-sensitive, and are silently truncated to 200
  41.      characters.
  42.  
  43.      The mmmmoooodddduuuulllleeeessss section describes the individual modules and drivers from
  44.      which the _S_T_R_E_A_M_S network configuration will be built.
  45.  
  46.      tcp    dc    /dev/tcp
  47.      arp    m     arp
  48.      x25    dc    /dev/x25
  49.      lapb0  dc    /dev/lapb0
  50.  
  51.      Each line (such as the examples above) consists of three tokens
  52.      (separated by whitespace) as follows.
  53.  
  54.      The mmmmoooodddduuuulllleeee iiiiddddeeeennnnttttiiiiffffiiiieeeerrrr is the name by which the module or driver will be
  55.      known in the streams section (see below).
  56.  
  57.      The mmmmoooodddduuuulllleeee ttttyyyyppppeeee is a sequence of character flags describing the module or
  58.      driver.  The flag 'dddd' describes a _S_T_R_E_A_M_S _d_r_i_v_e_r , whereas 'mmmm' describes
  59.      a _m_o_d_u_l_e. The 'cccc' flag specifies a driver to be _c_l_o_n_e_a_b_l_e. (See the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSNNNNEEEETTTTDDDD....OOOOPPPPTTTTIIIIOOOONNNNSSSS((((4444))))                                              SSSSNNNNEEEETTTTDDDD....OOOOPPPPTTTTIIIIOOOONNNNSSSS((((4444))))
  71.  
  72.  
  73.  
  74.      _S_T_R_E_A_M_S _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e for a detailed description of modules and
  75.      drivers.)
  76.  
  77.      The mmmmoooodddduuuulllleeee nnnnaaaammmmeeee is the _c_h_a_r_a_c_t_e_r _d_e_v_i_c_e _n_a_m_e for a driver, or the
  78.      _p_u_s_h_a_b_l_e _m_o_d_u_l_e _n_a_m_e for a module.
  79.  
  80.      The ssssttttrrrreeeeaaaammmmssss section describes the architecture of the network in terms of
  81.      how the previously defined modules and drivers are to be combined (by
  82.      means of the appropriate PUSHes and LINKs) into streams.  Multiplexing
  83.      and cloning are handled automatically by the _s_n_e_t_d(1M) utility.
  84.  
  85.      ip    arp      IP_NET=89.0.0.3
  86.      x25   lapb0    SHELL="x25tune -P -s A def.dte.x25" \
  87.                     X25_SET_SNID={A, LC_LAPBDTE, , }
  88.  
  89.      Lines in this section (such as the above examples) are of the following
  90.      form.
  91.  
  92.      The first two tokens on a line are nnnnaaaammmmeeeessss (_m_o_d_u_l_e _i_d_e_n_t_i_f_i_e_r_s as defined
  93.      in the previous section) of drivers or modules which are to form the
  94.      uuuuppppssssttttrrrreeeeaaaammmm and ddddoooowwwwnnnnssssttttrrrreeeeaaaammmm components respectively of a _S_T_R_E_A_M_S link.
  95.  
  96.      Each link performed between token 1 and token 2 generates a _m_u_x__i_d
  97.      (multiplexing identifier) which is associated with that link.  It is
  98.      possible to override the generated link by replacing token 2 with an
  99.      explicit mux_id, for example:
  100.  
  101.      lapb0    1     LL_SET_SNID=A \
  102.                     SHELL="lltune -P -p lapb -s B -d /dev/lapb0 def.lapb"
  103.  
  104.      This sets the _m_u_x__i_d associated with the link to 1111 ....
  105.  
  106.      These names may be _q_u_a_l_i_f_i_e_d by a suffix consisting of a colon (::::) and a
  107.      number (for example _a_r_p:_1) to signify a particular _i_n_s_t_a_n_t_i_a_t_i_o_n of a
  108.      module.  (An uninstantiated _n_a_m_e is an abbreviation for _n_a_m_e:0.)  Each
  109.      instantiation of a module can be thought of as a separate _b_l_o_c_k in a
  110.      _S_T_R_E_A_M_S Architecture diagram.  Separate instantiations would be
  111.      appropriate for, say, a module pushed above more than one driver, but not
  112.      for a cloneable multiplexed driver.
  113.  
  114.      Instantiations are used in the 'streams' section only, to instantiate
  115.      modules defined in the 'modules' section.  The following networking
  116.      example would run IP over two distinct networks:
  117.  
  118.      ip       dc     /dev/ip
  119.      arp      m      arp
  120.      ethr0    dc     /dev/ethr0
  121.      ethr1    dc     /dev/ethr1
  122.  
  123.      %%
  124.  
  125.      ip      arp:0   IP_NET=89.0.0.1
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSNNNNEEEETTTTDDDD....OOOOPPPPTTTTIIIIOOOONNNNSSSS((((4444))))                                              SSSSNNNNEEEETTTTDDDD....OOOOPPPPTTTTIIIIOOOONNNNSSSS((((4444))))
  137.  
  138.  
  139.  
  140.      arp:0   ethr0   ARP_TYPE
  141.  
  142.      ip      arp:1   IP_NET=89.0.0.2
  143.      arp:1   ethr1   ARP_TYPE
  144.  
  145.      The remainder of each line consists of a (possibly null) sequence of
  146.      _c_o_n_t_r_o_l _a_c_t_i_o_n_s to be performed on completion of the link in the order
  147.      specified.
  148.  
  149.      Each control action is of the form _f_u_n_c_t_i_o_n = _a_r_g_u_m_e_n_t-_l_i_s_t, where the
  150.      _a_r_g_u_m_e_n_t-_l_i_s_t is either a single string argument or a comma-separated
  151.      list enclosed in braces ({{{{ and }}}}).  Control actions requiring no
  152.      arguments may consist simply of the _f_u_n_c_t_i_o_n component.  Arguments
  153.      containing whitespace or any of the special characters listed above must
  154.      be quoted.
  155.  
  156.      A special dummy link exists, where no link is formed, but the control
  157.      action is executed.  This occurs when token 2 is a hyphen (((( ''''----'''' )))) ....
  158.  
  159.      For example:
  160.  
  161.      x25     -       SHELL="pvcmap -P"
  162.  
  163.      which is simply a shell call to execute ppppvvvvccccmmmmaaaapppp ....
  164.  
  165. FFFFIIIILLLLEEEESSSS
  166.      /_e_t_c/_c_o_n_f_i_g/_s_n_e_t_d._o_p_t_i_o_n_s
  167.  
  168. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  169.      snetd(1M), hosts(4).
  170.      _T_h_e _S_T_R_E_A_M_S _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e .
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.